Ajustado services para classe de erros. - #449

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@app/Exceptions/Integration/ExternalServiceException.php`:
- Around line 19-26: Update ExternalServiceException::fromFailedResponse so the
explicitly provided $service always remains authoritative when merging context
metadata. Replace the current spread-based merge with an array-union arrangement
that preserves ['service' => $service] even when $context contains a service
key.

In `@app/Http/Controllers/InstallmentController.php`:
- Line 41: Update the exception handling around SpreadsheetImporter::import() in
InstallmentController so InvalidArgumentException is caught before the broader
Throwable handler, preserving and returning its missing-header message instead
of replacing it with the generic error.

In `@app/Services/GoogleSheetsService.php`:
- Line 39: Update both Google Sheets fetch methods, including fetchSheet() and
the method at app/Services/GoogleSheetsService.php lines 219-219, to catch
ConnectionException alongside RequestException and wrap either in
ExternalServiceException; also add ExternalServiceException to fetchSheet()’s
declared exceptions.

In `@app/Services/MapasClient.php`:
- Around line 127-133: The MapasClient failure paths must stop storing
unsanitized upstream data in ExternalServiceException. In
app/Services/MapasClient.php lines 127-133, keep the error message stable using
only safe status and path fields, excluding the response body; at lines 210-214
and 228-229, redact query parameters from download URLs before storing or
reporting failures.

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/erros_plan.md`:
- Around line 30-37: Atualize a descrição de ExternalServiceException no
documento para classificá-la como exceção de integração ou técnica, substituindo
a referência atual a exceção de domínio e mantendo consistente com a hierarquia
em app/Exceptions/Integration/.
- Around line 154-164: Alinhe o plano para usar uma única lista e contagem de
controllers: corrija o título e a tabela que enumeram os controllers com catch,
e remova ou ajuste as referências posteriores nas linhas 191 e 289 para não
incluir MonitoringController, NotificationController e PaymentController se
permanecerem fora do escopo. Preserve FormalizationController fora da migração
conforme indicado.
- Line 9: Atualize o plano em docs/erros_plan.md para distinguir claramente
etapas históricas já concluídas do trabalho ainda pendente: marque o rollout
como histórico ou remova etapas concluídas, incluindo a fundação e migrações
mencionadas nas seções próximas às linhas 184-195 e 282-291. Preserve apenas
ações realmente futuras e deixe explícito o estado atual do plano.
- Around line 110-122: Atualize a documentação do handler de renderização para
refletir o comportamento de bootstrap/app.php: use JSON apenas quando
expectsJson() e não houver X-Inertia; nos demais casos, retorne
back()->withErrors(...), removendo o fallback implícito. Corrija também as
referências nas seções associadas para documentar que
ProjectStageController::return() é uma exceção e preserva back()->with('error',
...), mantendo o fluxo esperado por ReturnProcessModal.vue.

---

Nitpick comments:
In `@docs/erros_plan.md`:
- Line 41: Atualize o bloco de código Markdown na seção correspondente de
docs/erros_plan.md, adicionando um identificador de linguagem após as três
crases de abertura, como text ou tree, para eliminar o aviso MD040 do
markdownlint.

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/erros_plan.md`:
- Line 287: Atualize o passo histórico 3 em docs/erros_plan.md para alinhar seu
escopo com a seção 3.1: marque as referências a SpreadsheetImportService e
PUMLGeneratorService como substituídas ou remova-as, mantendo o passo limitado a
GoogleSheetsService e MapasClient. Preserve a indicação de que os demais
controllers possuem o escopo descrito na linha sobre InstallmentController,
ProjectController, UserController e OpeningController.

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/erros_plan.md`:
- Line 286: Before removing the legacy InvalidArgumentException renderer from
bootstrap/app.php, audit references across code, tests, and documentation
separately. Update the InvalidArgumentException throw in SyncProjectFilesJob and
preserve or revise the test asserting a 422 response, then verify no runtime
dependencies remain before deleting the handler.